home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 1 / Gold Medal Software Volume 1 (Gold Medal) (1994).iso / archive / unp315.arj / UNP.DOC < prev    next >
Text File  |  1993-09-25  |  33KB  |  855 lines
  1.           ┌┐  ┬ ┌┬─┐ ┬ ┬┬──┐       ┌──┬┐     ┌┐  ┌┬──┐
  2.           ││  │ ││ │ │ ││  │          ││    ─┤│  ││
  3.           ││  │ ││ │ │ │├──┘        ──┤│     ││  └┴─┬┐
  4.           ││  │ ││ │ │ ││             ││ ┌┐  ││     ││
  5.           └┴──┘ └┘ └─┘ └┘          └──┴┘ └┘ ─┴┴─ └──┴┘
  6.          ─────────────────────────────────────────────
  7.               Unregistered evaluation copy.
  8.  
  9.  
  10.                 Written by Ben Castricum
  11.  
  12.                  August 26, 1993
  13.  
  14.  
  15.        This is the documentation belonging to and explaining the use of:
  16.  
  17.                    UNP V3.15
  18.               Compressed executable file expander
  19.  
  20.  
  21.    TOPICS covered in this document:
  22.  
  23.      DISCLAIMER
  24.      PURPOSE OF UNP
  25.      REQUIREMENTS
  26.      GENERAL INFO
  27.      HOW TO USE UNP
  28.      UNP IN ACTION
  29.      MESSAGES
  30.          WHAT UNP CAN HANDLE
  31.          NOTES ON COMPRESSORS
  32.      ERRORLEVEL VALUES
  33.      WHERE TO FIND UNP
  34.      HOW TO REGISTER
  35.          STILL LOOKING
  36.          THANKS
  37.          CONTACTING ME
  38.  
  39.  
  40.  
  41. DISCLAIMER:
  42. -----------
  43. Although UNP has been tested on several systems, I cannot guarantee that
  44. UNP will be without bugs.  Therefore, I do not take responsibility for any
  45. damage directly or indirectly caused by UNP as a result of known or
  46. unknown errors in it.
  47.  
  48.  
  49.  
  50. PURPOSE OF UNP:
  51. ---------------
  52. UNP tries to reverse the action which programs like PKLITE and LZEXE
  53. perform.  In case you don't know, those programs use data compression on
  54. executable files.  Yet they leave these compressed files in a state such
  55. that they can still be normally executed.  This is great if you want to
  56. save disk space, but it has its disadvantages.  Anyone can now spread a
  57. virus; just compress an infected file and the virus is invisible!
  58. Debugging also becomes a lot more difficult since the code has become
  59. unreadable.  These are the primary reasons behind my writing UNP.  I
  60. could make up some story about loading/decompressing time, but we are
  61. probably talking about a few 100ths of a second.  Well, at least I don't
  62. notice any delay on my 66Mhz...
  63.  
  64. Not only can UNP expand compressed executable files, it is also able to
  65. remove other kinds of routines from such programs.  For instance,
  66. Central Point's Anti-virus (tm) Immunize codes can be safely removed.
  67. Though this removal is currently limited to only a few routines, in the
  68. future this ability might be greatly expanded.
  69.  
  70.  
  71.  
  72. REQUIREMENTS:
  73. -------------
  74. To run UNP you need at least a 8086 microprocessor.  However if you want
  75. to take full advantage of UNP, MS-DOS 5.0 (or higher) is recommended since
  76. UNP tries to allocate UMBs.  Lower versions of DOS will work without much
  77. difference since UNP only uses base memory and UMBs.  It requires about
  78. 15k of memory, with the additional amount of memory required depending on
  79. the program being processed.
  80.  
  81.  
  82.  
  83. GENERAL INFO:
  84. -------------
  85. Before you start using UNP, I would like to point out a few things which
  86. you might take into consideration.
  87.  
  88. Compressed EXE files containing an overlay may not work correctly after
  89. they have been decompressed.  Decompression expands the code size of the
  90. EXE file which also means that the overlay moves up.  Some programs do not
  91. check where the overlay currently is but just use a constant to get the
  92. overlay.  If this is the case, most anything can happen.
  93.  
  94. When you use UNP to convert a file to another structure, please take
  95. into consideration that the converted program never runs under the exact
  96. same conditions as it did before.  Though these differences are likely
  97. not to cause any problems with most programs, there are always programs
  98. which expect just that what is changed by conversion.
  99.  
  100. One way to protect yourself against problems caused by such problems is
  101. to use UNP's -b which is .BAK backup file creation option to create a
  102. copy of the original compressed file.  If, after running the
  103. uncompressed program you find an error, you can simply delete the bad
  104. copy and rename the .BAK file.
  105.  
  106.  
  107.  
  108. HOW TO USE UNP:
  109. ---------------
  110. To get help type UNP on the command line without parameters or use the
  111. '-?' switch.  The first line of the help screen is a short line
  112. describing how to pass information to UNP.  Let's analyze this step by
  113. step.
  114.  
  115.  
  116. usage: UNP command [options] [d:][/path]Infile [[d:][/path]Outfile]
  117.  
  118.  
  119. * commands:
  120. e = expand compressed file (default)
  121.    This command expands the compressed file.  If you do not specify a
  122.    command, UNP will use this by default.  Using this command without a
  123.    wildcard will result in unpacking all files in the current directory.
  124.  
  125. c = convert to COM file
  126.    Some .EXE files can be converted to .COM files.  You can do this by
  127.    using this command.  You should only convert a file when you know
  128.    exactly what you are doing (see general info section).
  129.  
  130. i = info only
  131.    If you just want some information about the file, this is the command
  132.    to use.  UNP will show all information like the E command but will
  133.    will not decompress or write the file back.
  134.  
  135. l = load and save, no decompressing (only for EXE files).
  136.    This command loads an .EXE file but does not expand it.  It will be
  137.    written back just like a decompressed file would be written back.  This
  138.    is useful in case you want to remove an overlay or remove irrelevant
  139.    header data.
  140.  
  141. s = search for compressed files
  142.    When you use this command, only a small list of compressed files
  143.    matching the Infile wildcard will be generated.  The list created will
  144.    be in the form of "filename.ext (compressor)".
  145.  
  146. x = convert to EXE file
  147.    Some compressors can only compress .EXE files (like LZEXE).  With this
  148.    command you can convert a .COM file to an .EXE file.  The resulting
  149.    file will be written back with an .EXE extension by default.
  150.  
  151.  
  152. * options:
  153. -? = help (this screen)
  154.    For a list of UNP commands or options use this switch.  Any other
  155.    switch or command used on the same line will be ignored.
  156.  
  157. -a = automatic retry
  158.    Some files have been altered more than once.  This switch will make
  159.    UNP to process the file again when it was changed.  Useful when you
  160.    want to uncompress a file which also has been Immunized by CPAV.
  161.  
  162. -b = make backup .BAK file of original
  163.    If you want to keep a backup of your original file (very wise) use this
  164.    switch.  The original file will be renamed to a file with a .BAK
  165.    extension.
  166.  
  167. -c = ask for confirmation before decompressing
  168.    This will force UNP to ask you if you want to decompress the file each
  169.    time it has found a new compressed file.
  170.  
  171. -h = remove irrelevant header data
  172.    Most linkers add useless data to the .EXE header.  This switch removes
  173.    all such useless information, thus shrinking the header size.
  174.  
  175. -i = do not intercept INT 21h calls
  176.    By default UNP watches the DOS interrupt (21h) to check if the program
  177.    is running as expected.  Any unexpected call to INT 21h will make UNP
  178.    abort the process.  If you have any weird TSRs resident you might have
  179.    to use this switch.  I had to use it while debugging with Turbo
  180.    Debugger.
  181.  
  182. -k = pklite signature; - = don't add, + = add always, ? = ask
  183.    With this switch you can handle the pklite signature.  There are 3
  184.    possibilities :
  185.    -k- = the pklite signature will not be added, this will also be the
  186.      case if you only use -k (to stay dislite compatible)
  187.    -k+ = always add the pklite signature, this is the default of UNP so
  188.      you can just as well leave the -k switch away if you want this
  189.    -k? = when you use this, UNP will ask you each time it has found a
  190.      signature (like UNP V3.01 or earlier did)
  191.  
  192. -l = allways use loadfix
  193.    Starting with V3.12, UNP will not fill the first 64k of base memory.
  194.    (this allows larger files to be processed)  When UNP detects a file
  195.    which does requires such a loadfix, it will reload the program with the
  196.    first 64k allocated.  If you are planning to unpack several EXEPACKed
  197.    files you might want to use this switch to avoid reloading.  This
  198.    switch can only improve UNP's processing speed, it does not add
  199.    anything new.
  200.  
  201. -o = overwrite output file if it exists
  202.    If you want to have the destination file overwritten, you can avoid
  203.    the question for permission by specifying this switch on the command
  204.    line.
  205.  
  206. -p = align header data on a page
  207.    It is said that .EXE files with a header size that is a multiple of
  208.    512 bytes load faster (this could make sense since a sector is also
  209.    512 bytes).  This switch will expand the header to the nearest
  210.    multiple of 512 bytes.
  211.  
  212. -r = remove overlay data
  213.    If something is appended to an .EXE it is called an overlay.  This
  214.    switch will let the file size of the outfile be the same as the load
  215.    image.  So anything that was appended to the file will be thrown away.
  216.    An overlay can be used for all kinds of data, so removing this can
  217.    result in throwing away something useful.
  218.  
  219. -u = update file time/date to current time/date
  220.    By default UNP sets the time/date of the destination file to the same
  221.    time/date as the original source file.  If you want to have it updated
  222.    to the current time/date use this switch
  223.  
  224. -v = verbose
  225.    When you use this switch UNP will give you some additional information.
  226.    I added this switch for debugging purposes.
  227.  
  228.  
  229. *[d:][/path]Infile
  230.    The wildcard UNP uses for selecting the files it will process can be
  231.    found as follows:
  232.    if you have specified a command but no Infile the wildcard '*.*' will
  233.    be used.  If you have specified an Infile ofcourse this will be used
  234.    except for wildcards without an extension; those will get '.*' appended
  235.    and a flag will be set to select only .COM and .EXE files.  If your
  236.    Infile ends with a '\', '*.*' will be appended.
  237.  
  238.  
  239. *[[d:][/path]Outfile]
  240.    The destination file is optional. If you don't specify one, the source
  241.    file will be overwritten.  You cannot use wildcards in this.  Also, you
  242.    should not specify a destination file when you want to decompress more
  243.    than one file.
  244.  
  245.  
  246.  
  247. UNP IN ACTION:
  248. --------------
  249. When you execute UNP you can get several lines of information. Following
  250. is an explanation of what those lines mean:
  251.  
  252.  
  253. processing file : [D:][PATH\]FILENAME.EXT
  254.  
  255.    This shows the name of the file being processed as specified on the
  256.    command line.
  257.  
  258.  
  259. file size       : X
  260.  
  261.    The file size reported by DOS will be shown here.
  262.  
  263.  
  264. file structure  :
  265.  
  266.    UNP recognizes 4 file structures:
  267.    - executable (EXE)
  268.       If the file starts with the 'MZ' or 'ZM' signature and does not
  269.       contain the 'NE' signature then this structure is assumed.  With EXE
  270.       files there are two options UNP recognizes:
  271.       - convertible
  272.          The file can be converted to a COM file structure.
  273.       - loads into high memory
  274.          The program is loaded as high as possible in the allocated memory
  275.          block (this requires some other loading routines).
  276.  
  277.    - Windows or OS/2 1.x new executable
  278.       The file starts with the 'MZ' or 'ZM' signature and contains the
  279.       'NE' signature.
  280.  
  281.    - data file
  282.       The file does not contain the 'MZ' or 'ZM' signature but is too
  283.       large to be a COM file.
  284.  
  285.    - binary (COM)
  286.       This is shown in all other cases.
  287.  
  288.  
  289. EXE part sizes  : header X bytes, code Y bytes, overlay Z bytes
  290.  
  291.    Of course you will only get this line if you are processing an EXE file.
  292.    This shows how the file is built up.  If you add X Y and Z you should
  293.    get the file size reported by DOS.
  294.  
  295.  
  296. processed with  :
  297.  
  298.    If UNP recognizes some program's work in the file, it will try to tell
  299.    you what program it recognizes and when possible what version of that
  300.    program.  If UNP does not really know what program has changed your
  301.    file but recognizes some programs work then that programs name will be
  302.    displayed between brackets (e.g. [EXEPACK]).  If you have got such a
  303.    file then there are two possibilities, UNP knows about this program but
  304.    it is just unsure about the name/version or UNP doesn't know about it
  305.    at all.  To find out if UNP knows about it, use the -v switch on this
  306.    program.  If you got a message about breakpoints (see MESSAGES) then
  307.    UNP doesn't know this routine, I appreciate it if you would send me
  308.    that program or tell me where to find it.
  309.  
  310.  
  311. action          :
  312.    UNP not only decompress files it has the ability to do other
  313.    things as well.  There can only be one action performed at a time.
  314.    This is a list of actions UNP reports:
  315.  
  316.    - decompressing... done
  317.       This is the decompression action, probably the most used action.
  318.  
  319.    - removing immunize code... done
  320.       When a file has been immunized with Central Point Anti-Virus, a
  321.       piece of code is added to the file.  UNP has the ability to remove
  322.       this code.
  323.  
  324.    - removing scrambling... done
  325.       UNP recognizes a few scrambling routines. When you see this message
  326.       you have got a program which contains one.
  327.  
  328.    - removing 'XX' signature
  329.       Starting with UNP V3.02, the PKLITE signature added to fake PKLITE
  330.       decompression can be removed.  This message will be shown if UNP has
  331.       found a removable signature and is trying to remove it.
  332.  
  333.    - converting to EXE file structure
  334.       The file will be converted to one with an .EXE file structure
  335.  
  336.    - converting to COM file structure
  337.       The file will be converted to one with an .COM file structure
  338.  
  339.  
  340. new size        : X
  341.  
  342.    When the file has been written back UNP reports the new file size to
  343.    you in this line.
  344.  
  345.  
  346. All other messages are explained in the section below.
  347.  
  348.  
  349.  
  350. MESSAGES:
  351. ---------
  352. UNP has 6 kinds of messages other than the usual information it can display:
  353.  
  354. * Questions.  Although I tried to make this program as smart as possible,
  355.   it still can't read minds and things like that.  So sometimes it will
  356.   ask you for something it wants to know.
  357.  
  358. Add 'pk'/'PK' signature to fake PKLITE decompression (y/n)?
  359.    This question will only appear if you use -k? on the command line.
  360.    Answering 'Y' to this question will add 14 bytes of code that fakes
  361.    PKLITE decompression.  The correct signature will be displayed and used
  362.    automatically ('pk' for V1.20 and others 'PK').
  363.  
  364. File FILENAME.EXT already exists.  Overwrite (y/n)?
  365.    The filename that UNP wants to write the resulting file to already
  366.    exists.  If you haven't specified the -o switch it will ask if it can
  367.    overwrite it.  Answering 'N' will proceed to the next file.
  368.  
  369. Program is protected, please enter password:
  370.    This question will appear when you are trying to decompress a program
  371.    which is compressed with TINYPROG with the password option.  You are
  372.    asked to type the password used.  This is not to verify whether you are
  373.    the rightful owner or not, but I just couldn't find a way around it.
  374.  
  375. Remove this routine from file (y/n)?
  376.    You have specified the -c switch and UNP has found a file it
  377.    recognizes as being processed with something.  Now it wants to know
  378.    if you like to remove the routine it has found.
  379.  
  380.  
  381. * INFO messages, these messages are only displayed when you have specified
  382.    the -V switch.  I've added them for debugging purposes.
  383.  
  384. INFO- Attempting to increase available memory for decompression.
  385.    This only shows up if you are trying to decompress PKLITE V1.00ß (2).
  386.    When this happens, UNP uses some other strategy to calculate the memory
  387.    it allocates for decompressing.  By default UNP only allocates as less
  388.    memory as possible.  This strategy allocates 15/16 of the memory block
  389.    the program is currently loaded in.
  390.  
  391. INFO - command line = " ... "
  392.    This message shows how UNP has interpreted the things you typed on the
  393.    command line.  Great for debugging purposes!
  394.  
  395. INFO - First 64K of base memory has been fully allocated.
  396.    Some compressors use the segment below their own code.  Since it is
  397.    possible to load the operating system in upper/high memory there might
  398.    not be a complete segment available.  This message tells you there has
  399.    been memory allocated to ensure there is a complete segment below.
  400.    Note that this is the same thing that the program LOADFIX.COM supplied
  401.    with MS-DOS 5 does.
  402.  
  403. INFO - Overlay copy overruled, overlay not copied to destination file.
  404.    Normally UNP copies any overlay found on the original program to the
  405.    destination.  This is one of the exceptions.  CRUNCHER and SEA-AXE use
  406.    the overlay to store the compressed data for the file.  Copying the
  407.    overlay would result in a program containing twice its code, once in
  408.    compressed and once in the decompressed form.  This message indicates
  409.    that UNP has removed the overlay to avoid this problem.
  410.  
  411. INFO - Program loaded at XXXXh, largest free memory block: X bytes.
  412.    Pretty obvious.  The address where UNP is loaded is displayed along
  413.    with the largest block it can allocate.
  414.  
  415. INFO - Unknown program, breakpoints are : GS-XXXX, GI-XXXX, QT-XXXX.
  416.    Some routines that I am using are a bit better than the rest because
  417.    they try to determine offsets rather than comparing signatures.  If
  418.    such a smart routine has found breakpoints but can not find any
  419.    identification string belonging to these, this message is shown with
  420.    the breakpoints it has found.
  421.  
  422. INFO - Using FILENAME.EXT as temp file.
  423.    UNP tells you what it will be using as temporary file.  This name is
  424.    composed of the TEMP variable and the default temporary name.
  425.  
  426. INFO - Wildcard matches X filename(s), stored at XXXXh.
  427.    This tells you how many filenames UNP has found that match the wildcard
  428.    and where it has stored the names found.
  429.  
  430.  
  431. * WARNING messages.  UNP sometimes takes actions the user should be
  432.    notified of.  In those cases a warning message is displayed.
  433.  
  434. WARNING - Adding 'XX' signature to fake PKLITE decompression.
  435.    The program you are decompressing was compressed by PKLITE V1.14 or
  436.    higher with extra compression.  By default UNP adds 14 bytes of code
  437.    that will let the program think it is still compressed.  To remove
  438.    this piece of code you can use UNP E on it.
  439.  
  440. WARNING - File adds 'XX' signature (added by UNP V3.01 or earlier).
  441. WARNING - File adds 'XX' signature (added by DISLITE V1.15 or higher).
  442.    Your file has already been decompressed and has the signature to fake
  443.    PKLITE decompression appended.  This signature is ignored to continue
  444.    the search for more decompression routines.
  445.    All signatures added by UNP V3.02 or higher and the DISLITE signatures
  446.    which do not use a relocation item will act as a decompression routine,
  447.    so UNP E will remove them.
  448.  
  449. WARNING - File already has .BAK extension, no backup created.
  450.    UNP has just unpacked a .BAK file and you have specified the -B switch.
  451.    Creating a .BAK file of a file which already has a .BAK extension is
  452.    impossible so the source file will be overwritten and there will be no
  453.    backup created.
  454.  
  455. WARNING - File loaded too low in memory to decompress, reloading.
  456.    Files compressed with EXEPACK require one segment (64k) below their own
  457.    code to successfully decompress.  When there is no complete segment
  458.    available, UNP displays this message and reloads the file higher in
  459.    memory. (also see msg. 'INFO - First 64K...' and -L switch)
  460.  
  461. WARNING - Infile and Outfile are same, Outfile ignored.
  462.    You have specified the file twice on the command line, meaning that the
  463.    destination file is the same as the source file.  Since this is the
  464.    default situation the second name is ignored.
  465.  
  466. WARNING - Invalid or missing stored header information.
  467.    Normally the compressor used on the program you are trying to
  468.    decompress stores a part of the original header.  UNP has compared
  469.    this information with the data it thinks it should be and has come to
  470.    the conclusion that these mismatch.  If this happens the default UNP
  471.    header will be used.
  472.  
  473. WARNING - Missing last byte, unable to completely restore file.
  474.    The SHRINK compressor does not correctly compresses files containing
  475.    all 256 characters.  When this has happened the last byte of the
  476.    program is thrown away.  It's not possible to get that byte back so the
  477.    decompressed file is mismatching in 1 or more bytes at the end with the
  478.    original file.
  479.  
  480. WARNING - Outfile specified, -B option ignored.
  481.    You have specified a destination file and the -B switch.  Because I see
  482.    no sense in this, the -B option will then be ignored.
  483.  
  484.  
  485. * ERROR messages.  In some cases the desired action cannot be performed or
  486.   has failed.  These messages tell you why this is so and what has
  487.   happened.  UNP will continue with the next file.
  488.  
  489. ERROR - Cannot handle this decompression routine.
  490.    UNP has recognized the way your program has been compressed but is not
  491.    (yet) able to decompress it.
  492.  
  493. ERROR - File already is a .COM file.
  494.    You are trying to convert a .COM file to a .COM file.
  495.  
  496. ERROR - File already is an .EXE file.
  497.    You are trying to convert a .EXE file to a .EXE file.
  498.  
  499. ERROR - File contains overlay.
  500.    One thing you can't have with .COM files is overlays.  If you want to
  501.    convert anyway first remove the overlay.
  502.  
  503. ERROR - File has invalid entrypoint (CS:IP <> FFF0h:0100h)
  504.    To have a converted .EXE file start at the right place, the programs
  505.    initial CS:IP should point to FFF0:0100h.  If this is not true you get
  506.    this error message.
  507.  
  508. ERROR - File has relocation items.
  509.    You tried to convert an .EXE file with relocation items to a .COM file.
  510.    A .COM file cannot handle relocation items.
  511.  
  512. ERROR - File is too large for .COM file.
  513.    The maximum size for a .COM file is much shorter than the one for an
  514.    .EXE file.  So it can happen that the .EXE file is too large to be
  515.    converted to a .COM file.
  516.  
  517. ERROR - Unexpected call to INT 21h, decompression failed.
  518.    When decompressing, UNP passes control to the program.  When it does
  519.    not get control back it is very likely that an interrupt 21h will take
  520.    place sooner or later (INT 21h is the most important interrupt).  UNP
  521.    checks for unexpected calls to this interrupt to ensure it's still in
  522.    control.  To disable this checking use the -i switch.
  523.  
  524.  
  525. * DOS ERROR messages, these errors are things UNP tried to do but for some
  526.   reason your Operating System didn't allowed it.  UNP will quit and will
  527.   have the I/O ERROR exit code.  If you find any use for UNP you are
  528.   probably an experienced DOS user and know how to solve the problem so I
  529.   will only give you the messages.
  530.  
  531. DOS ERROR - unable to create file
  532.  
  533. DOS ERROR - unable to open file
  534.  
  535. DOS ERROR - unable to read from file
  536.  
  537. DOS ERROR - unable to write to file
  538.  
  539.  
  540. * FATAL ERROR messages.  When one of those messages appear something is
  541.   really wrong and UNP cannot continue its work.  It will quit and
  542.   probably have an exitcode for the situation occurred.
  543.  
  544. FATAL ERROR - Decompressing many files into one.
  545.    You have specified a destination file, but there is more than one
  546.    source file.
  547.  
  548. FATAL ERROR - Divide overflow (INT 00h) generated by CPU.
  549.    This means that an invalid DIV instruction has been executed.
  550.    Normally this will cause DOS to terminate the program.  UNP hooks this
  551.    so it can set the interrupt's pointers back before the program quits.
  552.  
  553. FATAL ERROR - No files found matching FILENAME.EXT
  554.    UNP could not find any files to decompress.
  555.  
  556. FATAL ERROR - Not enough memory ...
  557.    UNP tried to allocated some memory but it got an error back.  This
  558.    message tells you what it needed the memory for.
  559.  
  560. FATAL ERROR - Output path/file must not contain '*' or '?'.
  561.    You have used wildcards in the destination file.  This is not allowed.
  562.  
  563. FATAL ERROR - User abort, ^C/^Break pressed (INT 23h).
  564.    Interrupt 23h is called when DOS detects that Ctrl-C or Ctrl-Break is
  565.    pressed.  UNP hooks this to be able to restore the interrupts it uses.
  566.  
  567.  
  568. WHAT UNP CAN HANDLE:
  569. --------------------
  570. Of course you would like to know what programs UNP can currently handle.
  571.  
  572. Well, here is a list of routines that UNP V3.15 is known to remove:
  573.  
  574. * routines found in .COM files
  575. CENTRAL POINT ANTI-VIRUS V1             ; immunize code
  576. COMPACK V4.4
  577. COMPACK V4.5
  578. DIET V1.00
  579. DIET V1.02b or V1.10a
  580. DIET V1.20
  581. ICE V1.00
  582. PKLITE V1.00ß
  583. PKLITE V1.03
  584. PKLITE V1.05
  585. PKLITE V1.12
  586. PKLITE V1.13
  587. PKLITE V1.14
  588. PKLITE V1.15
  589. PROTECT! COM/EXE V1.0 or V1.1
  590. PROTECT! COM/EXE V2.0
  591. PROTECT! COM/EXE V3.0
  592. PROTECT! COM/EXE V3.1
  593. PRO-PACK V2.08, emphasis on packed size
  594. PRO-PACK V2.08, emphasis on packed size, locked
  595. PRO-PACK V2.08, emphasis on unpacking speed
  596. PRO-PACK V2.08, emphasis on unpacking speed, locked
  597. SCRNCH V1.00
  598. SHRINK V1.00
  599.  
  600.  
  601. * routines found in .EXE files
  602. CENTRAL POINT ANTI-VIRUS V1             ; immunize code
  603. COMPACK V4.4
  604. COMPACK V4.5
  605. CRUNCHER V1.0                ; +.COM files
  606. DIET V1.01
  607. DIET V1.00d                ; small & large, with & without items
  608. DIET V1.02b, V1.10a or V1.20            ; small & large, with & without items
  609. DIET V1.44                              ; small, large + .COM files
  610. DIET V1.44, choose great SFX routine    ; small, large + .COM files
  611. DIET V1.45f                             ; small, large + .COM files
  612. DIET V1.45f choose great SFX routine    ; small, large + .COM files
  613. DISLITE V1.15 or higher                 ; small signatures (no items in sig)
  614. EXEPACK V4.00
  615. EXEPACK V4.05 or V4.06
  616. EXEPACK patched with EXPAKFIX V1.0
  617. LINK /EXEPACK V3.60 or V3.64
  618. LINK /EXEPACK V5.31.009
  619. KVETCH V1.02ß
  620. LZEXE V0.90
  621. LZEXE V0.91 or V1.00a
  622. PGMPAK V0.14
  623. PKLITE V1.00ß 0,1,2
  624. PKLITE V1.03  0,1,2,3
  625. PKLITE V1.05  0,1,2
  626. PKLITE V1.10  3
  627. PKLITE V1.12  0,1,2,3
  628. PKLITE V1.13  0,1,2,3
  629. PKLITE V1.14  0,1,2,3
  630. PKLITE V1.15  0,1,2,3
  631. PKLITE V1.20  1
  632. PKLITE V1.20  1,3
  633. PRO-PACK V2.08, emphasis on packed size
  634. PRO-PACK V2.08, emphasis on packed size, locked
  635. PRO-PACK V2.08, emphasis on unpacking speed
  636. PRO-PACK V2.08, emphasis on unpacking speed, locked
  637. PROTECT! COM/EXE V1.0
  638. PROTECT! COM/EXE V1.1
  639. PROTECT! COM/EXE V2.0
  640. PROTECT! COM/EXE V3.0
  641. PROTECT! COM/EXE V3.1
  642. SEA-AXE
  643. TINYPROG V1.0
  644. TINYPROG V3.3
  645. TINYPROG V3.6
  646. UNP V3.02 or higher                ; fake PKLITE signature
  647.  
  648. (Sorry, I lost count.  Who cares about statistics anyway?)
  649.  
  650.  
  651.  
  652. NOTES ON COMPRESSORS:
  653. ---------------------
  654. LZEXE V1.00a:
  655.    Several people have contacted me about this one.  This utility is the
  656.    same as LZEXE V0.91, except for some minor options.  It is offered
  657.    to the readers of INFO PC by IS2 France Diffusion (at least that's what
  658.    I think the text says).  Unfortunately I don't know where it's
  659.    available.
  660.  
  661. PGMPAK V0.14:
  662.    When you compress a file with this compressor, an overlay of 12 bytes
  663.    will be added.  To be exactly, the name and version number is added.
  664.    In this case: "PGMPAK V0.14".  This overlay is not automatically removed
  665.    when you decompress it.  To remove it, use the -R switch.
  666.  
  667. PKLITE:
  668.    PKLITE V1.00ß seems to have a bug in it.  While testing it, I found
  669.    that with some files an overlay of 512 bytes was added.  Needless to
  670.    say that when this happened the compressed file did not run correctly.
  671.    Since UNP writes the file back as it would be run in memory the file
  672.    decompressed with UNP wouldn't run either.  However extracting with
  673.    PKLITE -X resulted in the original file!  Since this version of pklite
  674.    is hardly used and even more unlikely is that someone wants to
  675.    decompress such a file I didn't bother to write a new routine that
  676.    fixes that bug.
  677.  
  678.    PKLITE V1.14 and up (according to the documentation) add the 'PK'
  679.    signature with extra compressed files to let the program check if it is
  680.    still compressed with PKLITE.  To avoid that the program detects it has
  681.    been decompressed UNP adds by default 14 bytes of code that places the
  682.    signature in the PSP like PKLITE does.
  683.  
  684. SCRUNCH:
  685.    In most cases, UNPs decompression routines are created when using
  686.    test files.  Unfortunately I don't have a copy of scrunch so this is
  687.    a bit difficult to ensure it works.  Of course there are other
  688.    decompression routines built the same way but the file I received
  689.    compressed with this compressor looked like it was converted to a
  690.    .COM file before it was compressed (it contained relocation items),
  691.    but this conversion could just as well be a part of the scrunch
  692.    compression.  If I receive more files compressed with this one I will
  693.    improve and adjust the routine when needed.
  694.  
  695. SHRINK V1.00:
  696.    This compressor is a bad implementation of Run Length compression.  It
  697.    contains two bugs one of which is in the decompression routine.  The
  698.    bugs are triggered when the file to be compressed contains all 256
  699.    bytes.  I have written my own decompression routine for this compressor
  700.    that is able to avoid one bug.  The other bug is that the last byte of
  701.    the compressed file is thrown away making it impossible to fully
  702.    rebuild the file.  If this is the case, UNP will display a warning.  It
  703.    is always better to decompress it, even if the last byte is missing.
  704.  
  705.  
  706.  
  707.  
  708. ERRORLEVEL VALUES:
  709. ------------------
  710.   0  no error occurred
  711.   1  help text is displayed
  712.   2  no files found to process
  713.   3  decompressing many files into 1 /  Outfile contains wildcards
  714.   4  some I/O error occurred
  715.   5  could not allocate enough memory
  716.   6  CPU generated divide overflow
  717.   7  user pressed ^C or ^Break
  718.  
  719.  
  720.  
  721. WHERE TO FIND UNP:
  722. ------------------
  723. Each time I have a new version of UNP available, I upload them to 2
  724. places:
  725. WSMR-SIMTEL20.Army.Mil (Simtel20)
  726.    Ask your local Internet or FTP expert on how to get them.
  727.  
  728. MegaVolt BBS (support site of unp)
  729.    tel. +31-30-211143
  730.    speeds up to 14k4
  731. If you need any help, got questions or files you want me to look at, you
  732. can call this BBS.  There is a special UNP menu with everything you need.
  733.  
  734.  
  735.  
  736.  
  737. HOW TO REGISTER:
  738. ----------------
  739. I have decided to release UNP as freewhere.  You are allowed to test this
  740. program freely for a period of two weeks.  If you decide to continue using
  741. UNP you are expected to let me (the author) know where you are using my
  742. program.  To do this, send a postcard with some picture of your city to
  743. the adress found at the end of the document.  I would appreciate if you
  744. would mention your full name and version you are using.  Ofcourse if you
  745. have got any suggestions you can put them on it as well!
  746.  
  747. Please don't feel offended by all of this, I just want to how much people
  748. find any use for UNP.  And hey, it beats sending money!
  749.  
  750.  
  751.  
  752. STILL LOOKING:
  753. --------------
  754. I am still trying to improve my program.  If you'd like to help me with
  755. that and you think you've got something useful, like a compressor or some
  756. other program that manipulates files, please contact me or mail me the
  757. program.
  758.  
  759.   Programs I own a copy of or have access to:
  760. COMPACK V4.4
  761. COMPACK V4.5
  762. CRUNCHER V1.0
  763. CENTRAL POINT ANTI-VIRUS V1
  764. DIET V1.00d
  765. DIET V1.02b
  766. DIET V1.10a
  767. DIET V1.20
  768. DIET V1.44
  769. DIET V1.45f
  770. EXEPACK V4.00
  771. EXEPACK V4.05
  772. EXEPACK V4.06
  773. KVETCH V1.02ß
  774. LINK V3.60
  775. LINK V3.64
  776. LZEXE V0.90
  777. LZEXE V0.91
  778. LZEXE V1.00a
  779. PGMPAK V0.14
  780. PKLITE V1.00ß
  781. PKLITE V1.03
  782. PKLITE V1.05
  783. PKLITE V1.12
  784. PKLITE V1.12 Professional
  785. PKLITE V1.13
  786. PKLITE V1.14
  787. PKLITE V1.15
  788. PKLITE V1.15 Professional
  789. PROTECT! EXE/COM V1.0
  790. PROTECT! EXE/COM V1.1
  791. PROTECT! EXE/COM V2.0
  792. PROTECT! EXE/COM V3.0
  793. SCRNCH V1.00
  794. SHRINK V1.00
  795. TINYPROG V1.0
  796. TINYPROG V3.3
  797. TINYPROG V3.6
  798.  
  799. I also have a copy of SYSPACK V0.1 and SLIM V1.10 but these programs do
  800. not really fit into UNP.
  801.  
  802.  
  803.  
  804. LATEST VERSION:
  805. ---------------
  806. People have asked me how I make my programs available to the public.
  807. Well, the first widespread version is V2.13 which I uploaded to Simtel
  808. (a large Internet repository containing many MS-DOS files).  I am unsure
  809. how files are handled on Simtel but it seems that a file uploaded there
  810. is made available on WSMR-SIMTEL20.Army.Mil and OAK.Oakland.Edu
  811. automatically. There are several additional anonymous FTP sites that
  812. mirror Simtel including wuarchive.wustl.edu.
  813.  
  814. Since I don't have FTP access I don't know how to get it through FTP :(
  815.  
  816.  
  817.  
  818. THANKS:
  819. -------
  820. Although I did all the programming, many people have helped me improve
  821. this program.  So thanks go to (in alphabetical order):
  822.  
  823. Kent Berggren, Vesselin Vladimirov Bontchev, Jan-Pieter Cornet,
  824. Kemal Djakman, Zago Franck, Tjalve Godager, Kai-Uwe Herbing,
  825. Hamish Hubbard, Yaron Keren, David Kirschbaum, Michael D. Lawler,
  826. Onno van der Linden, Brian Petersen, Inbar Raz, I. Romanek, Martin Saxer,
  827. Martin van der Vis, Simon Wiatr
  828.  
  829. And many others, including all those people who noticed the infamous LZEXE
  830. bug in V2.13.
  831.  
  832.  
  833.  
  834. CONTACTING ME:
  835. --------------
  836. If you want to contact me, my address and E-mail address can be found
  837. below this text.  Though E-mail used to be the fastest way to contact me,
  838. it might take some time after, let's say, May 1993.  After that I will
  839. probably be working as a trainee somewhere and don't know if I will have
  840. the time to go to the school on a regular basis.
  841.  
  842. I will respond, just don't expect a fast response.  However, after my
  843. trainee period ends (August 1994) I should have full access again for at
  844. least a year!
  845.  
  846.  
  847. My address:                       E-Mail (see above):
  848.   Ben Castricum                     benc@solist.htsa.aha.nl
  849.   Van Loenenlaan 10
  850.   1945 TX  Beverwijk
  851.   The Netherlands
  852.  
  853.  
  854. *** end of UNP V3.13 documentation ***
  855.